home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 2 / AACD 2.iso / AACD / Magazine / GraphicsCards / StormMesa / README < prev    next >
Text File  |  1998-12-15  |  27KB  |  715 lines

  1.  
  2.                                  Mesa 3.0
  3.  
  4.                      Copyright (C) 1995-1998  Brian Paul
  5.  
  6.  
  7.  
  8. Disclaimer
  9. ==========
  10.  
  11. Mesa is a 3-D graphics library with an API which is very similar to that
  12. of OpenGL*.  To the extent that Mesa utilizes the OpenGL command syntax
  13. or state machine, it is being used with authorization from Silicon Graphics,
  14. Inc.  However, the author makes no claim that Mesa is in any way a
  15. compatible replacement for OpenGL or associated with Silicon Graphics, Inc.
  16. Those who want a licensed implementation of OpenGL should contact a licensed
  17. vendor.  This software is distributed under the terms of the GNU Library
  18. General Public License, see the LICENSE file for details.
  19.  
  20. * OpenGL(R) is a registered trademark of Silicon Graphics, Inc.
  21.  
  22.  
  23.  
  24. Author
  25. ======
  26.  
  27. Brian Paul
  28. Avid Technology
  29. 6400 EnterPrise Lane, Suite 201
  30. Madison, WI  53719
  31.  
  32. brianp@elastic.avid.com
  33.  
  34. Formerly employed at the Space Science and Engineering Center at the
  35. University of Wisconsin - Madison.
  36.  
  37.  
  38.  
  39. Introduction
  40. ============
  41.  
  42. While Mesa uses the OpenGL API and mimics its semantics, it is
  43. important to understand that Mesa is not a real implementation of OpenGL
  44. since it is not licensed and has not been tested by the OpenGL conformance
  45. tests.  That said, Mesa is still a viable alternative to OpenGL.
  46.  
  47. Since version 2.0 Mesa implements the OpenGL 1.1 API specification.
  48. Only a few features are not yet implemented:
  49.  
  50.     trimmed NURBS
  51.     polygon antialiasing
  52.  
  53.  
  54. The primary design goal of this library has been correctness.  Common
  55. code paths are optimized for speed.  If you find that a particular
  56. rendering operation is slow let me know about it.  It may be a simple
  57. matter to optimize the operation in question.
  58.  
  59. I've been working on this library in my spare time since August, 1993.
  60. The core library was originally written on an Amiga using the DCC compiler.
  61. Later, development was moved to an SGI workstation.  Current development
  62. is done on SGI and PC/Linux systems.
  63.  
  64. Mesa works on most Unix workstations with ANSI C and X11.  There are also
  65. drivers for Amiga, Microsoft Windows, Macintosh, MS DOS, NeXT, and BeOS
  66. systems.  Look below for more information.
  67.  
  68. Since the OpenGL API is used, OpenGL documentation can serve as the
  69. documentation for Mesa's core functions.  Here are a few sources:
  70.  
  71.   WWW Center:   http://www.sgi.com/Technology/openGL/
  72.   Man pages:    http://www.digital.com:80/pub/doc/opengl/
  73.   Spec doc:     http://www.sgi.com/Technology/openGL/glspec/glspec.html
  74.  
  75.  
  76.  
  77. Getting the software
  78. ====================
  79.  
  80. The primary Mesa ftp site is iris.ssec.wisc.edu in the pub/Mesa directory.
  81. Mesa is also mirrored on sunsite in the directory pub/packages/development
  82. /graphics/mesa.
  83.  
  84. As of version 2.3, Mesa is distributed in two pieces:  main library code
  85. and demos.  If you're upgrading from a previous version of Mesa or you're not
  86. interested in the demos you can just download the core Mesa archive file.
  87.  
  88. Mesa is available in three archive formats:
  89.  
  90. 1. GNU zip/tar
  91.  
  92.     Download MesaLib-2.6.tar.gz and optionally MesaDemos-2.6.tar.gz
  93.     Unpack with:
  94.         gzcat MesaLib-2.6.tar.gz | tar xf -
  95.         gzcat MesaDemos-2.6.tar.gz | tar xf -
  96.  
  97. 2. Unix compressed/tar
  98.  
  99.     Download MesaLib-2.6.tar.Z and optionally MesaDemos-2.6.tar.Z
  100.     Unpack with:
  101.         zcat MesaLib-2.6.tar.Z | tar xf -
  102.         zcat MesaDemos-2.6.tar.Z | tar xf -
  103.  
  104. 3. ZIP format
  105.  
  106.     Download MesaLib-2.6.zip and optionally MesaDemos-2.6.zip
  107.     Unpack with:
  108.         unzip MesaLib-2.6.zip
  109.         unzip MesaDemos-2.6.zip
  110.  
  111.  
  112. After unpacking you should have the following files in the new Mesa-2.6
  113. directory:
  114.  
  115. README        - this file
  116. README.*    - detailed information for specific OS/hardware systems
  117. LICENSE        - the GNU library license
  118. IAFA-PACKAGE    - description file
  119. VERSIONS    - version history
  120. RELNOTES    - version-specific release notes
  121. FUTURE        - future development plans/ideas
  122. CONFORM        - results of conformance testing
  123. Makefile    - top-level Makefile
  124. Make-config    - system configurations used by the Makefiles
  125. mklib.*        - shell scripts for making shared libraries for some systems
  126. include/    - client include files
  127. lib/        - client libraries, created during installation
  128. src/        - source code for core library
  129. src-glu/    - source code for utility library
  130. util/        - handly utility functions
  131. widgets-mesa/    - Mesa widgets for Xt/Motif
  132. widgets-sgi/    - SGI OpenGL widgets for Xt/Motif
  133. NeXT/        - NeXT demo programs
  134. BeOS/        - BeOS demo programs
  135. mondello/    - Cirrus Logic Mondello 3-D accelerator code
  136. *mms*        - makefiles for VMS
  137. OpenStep/    - OpenStep files
  138. ggi/        - Linux GGI demos
  139.  
  140. and if you downloaded and unpacked the demos:
  141.  
  142. src-glut/    - source code for GLUT toolkit
  143. demos/        - GLUT demos
  144. xdemos/        - X11 and SVGA demo programs
  145. samples/    - sample OpenGL programs from SGI
  146. book/        - example programs from the OpenGL Programming Guide,
  147.           converted to GLUT by Mark Kilgard, from GLUT distribution.
  148. 3Dfx/        - 3Dfx demos and tests
  149. mtdemos/    - multi-threading demos
  150.  
  151.  
  152. Other Mesa-related stuff is at  ftp://iris.ssec.wisc.edu/pub/Mesa/contrib/
  153.  
  154.  
  155.  
  156. GLUT
  157. ====
  158.  
  159. Mesa 2.5 and later includes Mark Kilgard's GLUT library (GL Utility Toolkit).
  160. GLUT is built automatically on systems which support it.
  161.  
  162. The GLUT tests, demos, examples, etc are not included, just the main library.
  163. To obtain the latest complete release of GLUT please visit
  164. http://reality.sgi.com/employees/mjk_asd/glut3/glut3.html
  165.  
  166.  
  167.  
  168. Compiling and Installation
  169. ==========================
  170.  
  171. See the appropriate README.* file for system-specific instructions:
  172.  
  173.  
  174.     System                README file
  175.     -----------------        ------------
  176.     Unix/X11            README.X11
  177.     Windows 95/N%            README.WIN32
  178.     DOS                README.DOS
  179.     Linux/Windows w/ 3Dfx hardware    README.3DFX
  180.     Linux with GGI            README.GGI
  181.     Linux with threading        README.MITS
  182.     Amigas with Amiwin        README.AMIWIN
  183.     BeOS                README.BEOS
  184.     LynxOS                README.LYNXOS
  185.     SciTech MGL            README.MGL
  186.     IBM OS/2            README.OS2
  187.     Windows w/ S3 Virge hardware    README.VIRGE
  188.     VMS                README.VMS
  189.  
  190.  
  191. Header and library files:
  192.    After you've compiled Mesa and tried the demos I recommend the following
  193.    procedure for "installing" Mesa on Unix systems.
  194.  
  195.    Copy the Mesa include/GL directory to /usr/local/include:
  196.     cp -r include/GL /usr/local/include
  197.  
  198.    Copy the Mesa library files to /usr/local/lib:
  199.     cp lib/* /usr/local/lib
  200.  
  201.     (actually, use "cp -d" on Linux to preserve symbolic links)
  202.  
  203.    Create a few symbolic links so that compiling OpenGL applications is easy:
  204.     cd /usr/local/lib
  205.     IF USING STATIC (lib*.a) FILES THEN
  206.         ln -s libMesaGL.a libGL.a
  207.         ln -s libMesaGLU.a libGLU.a
  208.     ELSE
  209.         ln -s libMesaGL.so libGL.so
  210.         ln -s libMesaGLU.so libGLU.so
  211.     ENDIF
  212.  
  213.  
  214. Configuration options:
  215.    The file src/config.h has many parameters which you can adjust such
  216.    as maximum number of lights, clipping planes, maximum texture size,
  217.    etc.  In particular, you may want to change DEPTH_BITS from 16 to 32
  218.    if a 16-bit depth buffer isn't precise enough for your application.
  219.    After changing config.h you must recompile Mesa.
  220.  
  221.  
  222.  
  223. Using the Library
  224. =================
  225.  
  226. Performance Tips:
  227.    1. Turn off smooth shading when you don't need it (glShadeModel)
  228.    2. Turn off depth buffering when you don't need it.
  229.    3. Turn off dithering when not needed.
  230.    4. Use double buffering as it's often faster than single buffering
  231.    5. Compile in the X Shared Memory extension option if it's supported
  232.       on your system by adding -DSHM to CFLAGS and -lXext to XLIBS for
  233.       your system in the Make-config file.
  234.    6. Recompile Mesa with more optimization if possible.
  235.    7. Try to maximize the amount of drawing done between glBegin/glEnd pairs.
  236.    8. Use the MESA_BACK_BUFFER variable to find best performance in double
  237.       buffered mode.  (X users only)
  238.    9. Optimized polygon rasterizers are employed when:
  239.          rendering into back buffer which is an XImage
  240.          RGB mode, not grayscale, not monochrome
  241.          depth buffering is GL_LESS, or disabled
  242.          flat or smooth shading
  243.          dithered or non-dithered
  244.          no other rasterization operations enabled (blending, stencil, etc)
  245.   10. Optimized line drawing is employed when:
  246.          rendering into back buffer which is an XImage
  247.          RGB mode, not grayscale, not monochrome
  248.          depth buffering is GL_LESS or disabled
  249.          flat shading
  250.          dithered or non-dithered
  251.          no other rasterization operations enabled (blending, stencil, etc)
  252.   11. Textured polygons are fastest when:
  253.          using a 3-component (RGB), 2-D texture
  254.          minification and magnification filters are GL_NEAREST
  255.          texture coordinate wrap modes for S and T are GL_REPEAT
  256.          GL_DECAL environment mode
  257.          glHint( GL_PERSPECTIVE_CORRECTION_HINT, GL_FASTEST )
  258.          depth buffering is GL_LESS or disabled
  259.   12. Lighting is fastest when:
  260.          Two-sided lighting is disabled
  261.          GL_LIGHT_MODEL_LOCAL_VIEWER is false
  262.          GL_COLOR_MATERIAL is disabled
  263.          No spot lights are used (all GL_SPOT_CUTOFFs are 180.0)
  264.          No local lights are used (all position W's are 0.0)
  265.          All material and light coefficients are >= zero
  266.   13. XFree86 users:  if you want to use 24-bit color try starting your
  267.       X server in 32-bit per pixel mode for better performance.  That is,
  268.       start your X server with
  269.          startx -- -bpp 32
  270.       instead of
  271.          startx -- -bpp 24
  272.   14. Try disabling dithering with the MESA_NO_DITHER environment variable.
  273.       If this env var is defined Mesa will disable dithering and the
  274.       command glEnable(GL_DITHER) will be ignored.
  275.  
  276.  
  277. Debugging:
  278.    Normally Mesa records but does not notify the user of errors.  It is up
  279.    to the application to call glGetError to check for errors.  Mesa supports
  280.    an environment variable, MESA_DEBUG, to help with debugging.  If MESA_DEBUG
  281.    is defined, a message will be printed to stdout whenever an error occurs.
  282.  
  283.    More extensive error checking is done when Mesa is compiled with the
  284.    DEBUG symbol defined.  You'll have to edit the Make-config file and
  285.    add -DDEBUG to the CFLAGS line for your system configuration.  You may
  286.    also want to replace any optimization flags with the -g flag so you can
  287.    use your debugger.  After you've edited Make-config type 'make clean'
  288.    before recompiling.
  289.  
  290.    In your debugger you can set a breakpoint in gl_error() to trap Mesa
  291.    errors.
  292.  
  293.    There is a display list printing/debugging facility.  See the end of
  294.    src/dlist.c for details.
  295.  
  296.  
  297. Fortran bindings:
  298.    Fortan bindings are no longer included with Mesa.  William F. Mitchell
  299.    (william.mitchell@nist.gov) has developed a new set of Mesa/OpenGL and
  300.    GLUT bindings for Fortran.  See http://math.nist.gov/f90gl for more
  301.    information.
  302.  
  303.  
  304. Off-screen rendering:
  305.    Mesa 1.2.4 introduced off-screen rendering, a facility for generating
  306.    3-D imagery without having to open a window on your display.  Mesa's
  307.    simple off-screen rendering interface is completely operating system
  308.    and window system independent so programs which use off-screen rendering
  309.    should be very portable.  This new feature effectively enables you to
  310.    use Mesa as an off-line, batch-oriented renderer.
  311.  
  312.    The "OSMesa" API provides 3 functions for making off-screen renderings:
  313.    OSMesaCreateContext(), OSMesaMakeCurrent(), and OSMesaDestroyContext().
  314.    See the Mesa/include/GL/osmesa.h header for more information.  See the
  315.    demos/osdemo.c file for an example program.   There is no facility for
  316.    writing images to files.
  317.  
  318.    If you want to generate large images (larger than 1280x1024) you'll
  319.    have to edit the src/config.h file to change MAX_WIDTH and MAX_HEIGHT
  320.    then recompile Mesa.  Image size should only be limited by available
  321.    memory.
  322.  
  323.  
  324. Profiling:
  325.    Mesa 1.2.6 introduced a simple profiling facility.  It counts and
  326.    measures the time spent in a number of important rendering operations
  327.    and prints the information in a report before your program exits.
  328.  
  329.    By default, profiling is disabled.  To enable it, add -DPROFILE to
  330.    the appropriate CFLAGS entry in the Make-config file, then recompile
  331.    Mesa.  In general, you should only enable profiling during program
  332.    development to gain insight into Mesa's performance.  Mesa runs a bit
  333.    slower when profiling is enabled because it requires frequent polling
  334.    of the system clock.
  335.  
  336.    The profiling report will be printed when glXDestroyContext is called
  337.    _if_ the MESA_PROFILE environment variable is set.  You must be sure
  338.    glXDestroyContext is called before exiting to get the profile report.
  339.    The report will be printed to stdout and includes:
  340.  
  341.       glBegin/glEnd - number of glBegin/glEnd pairs called, total time,
  342.          and rate in pairs/second.
  343.       vertexes transformed - number of vertices transformed, lit, clip-
  344.          tested, fogged, and mapped to window coordinates, total time,
  345.          and rate in vertexes/second.
  346.       points rasterized - number of points drawn, time, and rate.
  347.       lines rasterized - number of lines drawn, time, and rate.
  348.       polygons rasterized - number of polygons drawn, time and rate.
  349.       overhead - time between glBegin/glEnd not accounted for by vertexes,
  350.          points, lines, and polygons.  This is time spent executing
  351.          glVertex, glNormal, glColor, etc, clipping, primitive assembly,
  352.          and user code between glBegin/glEnd.
  353.       glClear - number of glClears executed, total time and clears/second.
  354.       SwapBuffers - number of swaps executed, total time and swaps/second.
  355.  
  356.    Note that the real point, line, and polygon rates should be computed by
  357.       adding in the vertex transformation and overhead time factors.
  358.  
  359.  
  360. Linux SVGA driver:
  361.    Mesa 1.2.6 has a preliminary Linux SVGA driver for Mesa.  It's based
  362.    on the SVGA library included with Linux.  The driver isn't finished
  363.    yet.  I'm not too familiar with SVGA graphics so I could use some help
  364.    finishing it.  Contact Brian if you want to help.
  365.  
  366.    To enable the SVGA driver, edit the Make-config file and add -DSVGA to
  367.    the CFLAGS for Linux and add -lvga to the LIBS variable.  There are
  368.    several test programs (vtest.c, vgears.c, vindex.c) in the demos
  369.    directory.  See the include/GL/svgamesa.h and src/svgamesa.c files for
  370.    more information about the driver.
  371.  
  372.  
  373. Extensions:
  374.    The following OpenGL extensions are currently implemented:
  375.  
  376.       GL_EXT_blend_color - allows blending with a constant color
  377.       GL_EXT_blend_minmax - blend min/max operator
  378.       GL_EXT_blend_logic_op - allows glLogicOp to work in RGBA mode
  379.       GL_EXT_blend_subtract - blend subtraction operator
  380.       GL_EXT_polygon_offset - polygon Z offset
  381.       GL_EXT_vertex_array - vertex array extension
  382.       GL_EXT_texture_object - texture objects
  383.       GL_EXT_texture3D - 3D texture mapping
  384.       GL_EXT_paletted_texture - for color indexed textures
  385.       GL_EXT_shared_texture_palette - shared texture palette
  386.       GL_EXT_point_parameters - point parameters as a function of Z
  387.       GL_EXT_rescale_normal - rescale normal vectors
  388.       GL_EXT_abgr - GL_ABGR pixel format
  389.       GL_EXT_multitexture - multitexture extension (SPEC MAY CHANGE!!!)
  390.       GL_SGIS_multitexture - multitexture extension (NOT RECOMMENDED!!!)
  391.       GL_SGIS_texture_edge_clamp - limit texture filtering to texture edge
  392.  
  393.    For detailed information about the extensions see www.opengl.org
  394.    Other OS-specific extensions are documented in the other README.* files.
  395.  
  396.    There are a few Mesa-specific extensions:
  397.  
  398.    GL_MESA_window_pos
  399.  
  400.       This extension adds the glWindowPos*MESA() functions.  These functions
  401.       are convenient alternatives to glRasterPos*() because they set the
  402.       current raster position to a specific window coordinate, bypassing the
  403.       usual modelview, projection and viewport transformations.  This is
  404.       especially useful for setting the position for glDrawPixels() or
  405.       glBitmap() to a specific window coordinate.
  406.  
  407.       X and Y parameters (positive and negative) are directly mapped to
  408.       window coordinates.  Z is a depth value clamped to the range [0,1].
  409.       W is directly mapped.  The current raster position valid flag is
  410.       always set to true.  The current raster distance is set to zero.
  411.       The current raster color and texture coordinate are updated in the
  412.       same manner as glRasterPos().  In selection mode a hit record is
  413.       always generated.
  414.  
  415.       Programs using OpenGL, not Mesa, may also use the glWindowPos*MESA()
  416.       functions by including winpos.h from the src directory and by
  417.       compiling and linking with the winpos.c file from the src directory.
  418.  
  419.    GL_MESA_resize_buffers
  420.  
  421.       This extension adds the glResizeBuffersMESA() function.  When this
  422.       function is called, Mesa checks if the color buffer (window) has
  423.       been resized.  If it has, Mesa reallocates the ancillary (depth,
  424.       stencil, accum) buffers.
  425.  
  426.       Normally, Mesa checks for window size changes whenever glViewport()
  427.       is called.  In some applications it may not be appropriate to call
  428.       glViewport() when the window is resized.  Such applications should
  429.       call glResizeBuffersMESA() instead so the ancillary buffers are
  430.       correctly updated.
  431.  
  432.       This extension is new in version 2.2.
  433.  
  434.  
  435. Version 2.x features:
  436.    Version 2.x of Mesa implements the OpenGL 1.1 API with the following
  437.    new features.
  438.  
  439.    Texture mapping:
  440.     glAreTexturesResident
  441.     glBindTexture
  442.     glCopyTexImage1D
  443.     glCopyTexImage2D
  444.     glCopyTexSubImage1D
  445.     glCopyTexSubImage2D
  446.     glDeleteTextures
  447.     glGenTextures
  448.     glIsTexture
  449.     glPrioritizeTextures
  450.     glTexSubImage1D
  451.     glTexSubImage2D
  452.  
  453.    Vertex Arrays:
  454.     glArrayElement
  455.     glColorPointer
  456.     glDrawElements
  457.     glEdgeFlagPointer
  458.     glIndexPointer
  459.     glInterleavedArrays
  460.     glNormalPointer
  461.     glTexCoordPointer
  462.     glVertexPointer
  463.  
  464.    Client state management:
  465.     glDisableClientState
  466.     glEnableClientState
  467.     glPopClientAttrib
  468.     glPushClientAttrib
  469.  
  470.    Misc:
  471.     glGetPointer
  472.     glIndexub
  473.     glIndexubv
  474.     glPolygonOffset
  475.  
  476.  
  477. Version 3.x features:
  478.    Version 3.x of Mesa implements the OpenGL 1.2 API with the following
  479.    new features:
  480.  
  481.    BGR, BGRA and packed pixel formats
  482.    New texture border clamp mode
  483.    glDrawRangeElements()
  484.    standard 3-D texturing
  485.    advanced MIPMAP control
  486.    separate specular color interpolation
  487.  
  488.  
  489. Summary of environment variables:
  490.    MESA_DEBUG - if defined, error messages are printed to stderr
  491.    MESA_NO_DITHER - disable dithering, overriding glEnable(GL_DITHER)
  492.    MESA_RGB_VISUAL - specifies the X visual and depth for RGB mode (X only)
  493.    MESA_CI_VISUAL - specifies the X visual and depth for CI mode (X only)
  494.    MESA_BACK_BUFFER - specifies how to implement the back color buffer (X only)
  495.    MESA_PRIVATE_CMAP - force aux/tk libraries to use private colormaps (X only)
  496.    MESA_GAMMA - gamma correction coefficients (X only)
  497.    MESA_PROFILE - enable reporting of performance measurements
  498.    MESA_XSYNC - enable synchronous X behavior (for X debugging only)
  499.  
  500.  
  501.  
  502. Mailing List
  503. ============
  504.  
  505. There is a Mesa mailing list.  Its purpose is to let Mesa users exchange
  506. any ideas, questions, and/or problems they have.  To subscribe, send the
  507. following message to the address mesa-request@iqm.unicamp.br
  508.  
  509.     add yourname@your.internet.address mesa
  510.  
  511. For example:
  512.  
  513.     add brianp@elastic.avid.com mesa
  514.  
  515. You will receive a welcome message from the list server when you have been
  516. added to the list.
  517.  
  518. To unsubscribe from the list send the following message to
  519. mesa-request@iqm.unicamp.br
  520.  
  521.     del yourname@your.internet.address mesa
  522.  
  523. Thanks to Pedro Vazquez (vazquez@iqm.unicamp.br) for setting up and
  524. maintaing the list.
  525.  
  526.  
  527.  
  528. WWW Page
  529. ========
  530.  
  531. There is a Mesa WWW page:  http://www.ssec.wisc.edu/~brianp/Mesa.html
  532.  
  533.  
  534.  
  535. Contributed code
  536. ================
  537.  
  538. There is a contrib/ subdirectory on the Mesa ftp site which contains
  539. contributions from Mesa users.  See the README file in that directory for
  540. more information.
  541.  
  542. Anyone is welcome to contribute code to the Mesa project, provided you
  543. agree to the GNU license.
  544.  
  545. If you're contribution code to the Mesa library itself:
  546.    1. Try to write clean code (uniform indentation, comments, meaningful
  547.       identifiers, etc).  It must be readable and maintainable!
  548.    2. Test your code.  On several occations I've incorporated code from
  549.       users which later turned out to have bugs.  Now, I'm pretty hesitant
  550.       to use code which doesn't look good.
  551.  
  552. If you're contributing changes to Makefile or Make-config be sure your
  553. changes won't cause headaches for other users.  If you're not sure then
  554. maybe a new config target is appropriate.
  555.  
  556.  
  557.  
  558. Reporting Bugs
  559. ==============
  560.  
  561. If you think you've found a bug in Mesa first check if a newer version of
  562. Mesa is available.  Next, check ftp://iris.ssec.wisc.edu/pub/Mesa to see
  563. if a patch for your bug is there.  Otherwise, report the problem.
  564.  
  565. Since many people have contributed code to Mesa it's important that you
  566. report a bug to the right person:
  567.  
  568. Area            Contact
  569. ----------------------    -------------------------------------------
  570. GLU polygon tessellator    Bogdan Sikorski  bogdan@cira.it
  571. GLU NURBS        Bogdan Sikorski  bogdan@cira.it
  572. Evaluators        Bernd Barsuhn  bernd@berlin.muc.de
  573. Xt/Motif widgets    Thorsten Ohl  ohl@crunch.ikp.physik.th-darmstadt.de
  574.               and Jeroen van der Zijp  jvz@cyberia.cfdrc.com
  575. Fortran bindings    William Mitchell  william.mitchell@nist.gov
  576. Amiga driver        Stefan Zivkovic  d94sz@efd.lth.se
  577. Amiwin driver        Victor Ng-Thow-Hing  victorng@dgp.toronto.edu
  578. Macintosh driver    Miklos Fazekas  boga@augusta.elte.hu
  579. NeXT driver        Pascal Thibaudeau pthibaud@frbdx11.cribx1.u-bordeaux.fr
  580. OS/2 driver        Darren Abbott  abbott@hiwaay.net
  581. VMS support        Jouk Jansen  joukj@crys.chem.uva.nl
  582. Windows 95/NT driver    Theodore A. Jump  tjump@spgs.com
  583. MS-DOS driver        Charlie Wallace  cwallace@dreamworks.com
  584. BeOS driver        Tinic Uro  5uro@informatik.uni-hamburg.de
  585. GLX encoder/decoder    Steven Parker  sparker@taz.cs.utah.edu
  586. 3Dfx driver        David Bucciarelli  tech.hmw@plus.it
  587. SciTech MGL driver    Kendall Bennett  KendallB@scitechsoft.com
  588. Cygnus Win32 support    Stephane Rehel  rehel@kluster.com
  589. S3 Virge driver        rkoduri@s3.com or pcgamedev@s3.com
  590. Multithreading work    John Stone  johns@umr.edu
  591. Mailing list help    Pedro Vazquez  vazquez@iqm.unicamp.br
  592.  
  593. EVERYTHING ELSE-->    Brian Paul  brianp@elastic.avid.com
  594.  
  595. Feel free to cc Brian on messages sent to anyone listed above.  None of
  596. the people on this list are under any obligation to respond to bug reports.
  597. However, they have been pretty helpful so far.
  598.  
  599. When you report a bug please give as much information as possible including
  600. your hardware/software environment, which version of Mesa you're using, how
  601. to reproduce the problem, and if possible, a test program.
  602.  
  603.  
  604.  
  605. Known Bugs
  606. ==========
  607.  
  608. 1. Evaluator automatic normal vectors are miscalculated under certain
  609.    conditions.
  610.  
  611. 2. glCopyPixels gives undefined results when source and destination regions
  612.    overlap and pixel zoom!=1.0.
  613.  
  614. 3. Mesa doesn't work too well on Crays.  The problem is that Crays do not
  615.    have the exact C data type sizes which Mesa's X driver relies on.  Better
  616.    Cray support may or may not be seen in the future.
  617.  
  618. 4. gluCylinder, and probably other GLU quadrics, don't generate texture
  619.    coordinates when drawing in point or line mode.
  620.  
  621. 5. NURBS code does not copy user supplied data as it should; it just
  622.    stores pointers to that data. For the moment all data must be valid and
  623.    available utill the gluEndSurface() or the gluEndCurve() call.
  624.  
  625.  
  626.  
  627. Future Plans
  628. ============
  629.  
  630. 1. Display list optimization:  scan for duplicate vertices and normals in
  631.    order to reduce number of transformations needed.
  632.  
  633. 2. Implement a "generational" depth buffer which only has to be cleared
  634.    once every 'n' frames.
  635.  
  636. 3. Integrate Mesa into the XFree86 X server.
  637.  
  638. 5. Reorganize src/ directory: put drivers in separate directories.
  639.  
  640.  
  641.  
  642. Why is it the library called Mesa?
  643. ==================================
  644.  
  645. Why not?  More obvious names were considered but had to be rejected:
  646. FreeGL (too similar to the trademarked name OpenGL), Free3D (too similar
  647. to DEC's Open3D).  Also, I'm tired of acronyms.
  648.  
  649. [I've recently discovered that at least two other software products use the
  650. name Mesa.  A name change may be necessary in the future.  Suggestions are
  651. welcome!]
  652.  
  653.  
  654.  
  655. Contributors
  656. ============
  657.  
  658. Many people have contributed to Mesa.  I really appreciate the help!
  659. Among the contributors are:
  660.  
  661. Erich Stefan Boleyn - for the glRotate code and testing early Mesa
  662. Joe Kiniry, Kendall Bennett - for opinions and discussion
  663. Marc Buffat - for the gluProject and gluUnproject functions
  664. Bernd Barsuhn, Volker Weiss - for the new implementation of evaluators
  665. Philip Brown - for the initial GLX, GLUT implementation
  666. Thorsten Ohl - for glXUseXFont() and glBitmap bug fixes
  667. Thomas Malik - for new invert_matrix and other xform.c code
  668. Michael Pichler - for X colormap code and numerous bug reports/fixes
  669. Thorsten Ohl, Jeroen van der Zijp - for the Xt/Motif widgets
  670. Bob Mercier - for the new 8-bit RGB dithering code
  671. Pedro Vazquez - for establishing the Mesa mailing list
  672. Bogdan Sikorski - for the GLU polygon tessellation code and NURBS
  673. Linas Vepstas - for his extrusion and swept surface library
  674. Frederic Devernay - for improved X shared memory support
  675. Asif Khan - for bringing _many_ subtle bugs to my attention
  676. Mark Peterson - for the MS Windows driver for Mesa
  677. Gene Lett and Kerris Renkin - for diagnosing several rasterization problems
  678. Alex De Bruyn - for HP Color Recovery display support
  679. Miklos Fazekas - for the Macintosh driver
  680. Frederic Devernay - for many Sun configs and lots of useful feedback
  681. Victor Ng-Thow-Hing - for the Amiga AmiWin port
  682. Bill Triggs - improved texture mapping features
  683. Martin Bernhard - added texture coordinate generation to GLU quadric functions
  684. Pascal Thibaudeau - NeXT support
  685. Jean-Luc Daems, Jacques Leroy - numerous optimization in Mesa 1.2.7
  686. Joerg Hessdoerfer - 16-bit TrueColor optimizations in Mesa 1.2.7
  687. Stefan Zivkovic - for the Amiga driver
  688. Peter McDermott - for the Cirrus Logic Mondello driver
  689. Constantin Filin - for mipmapping/texture mapping code
  690. Darren Abbott - for the OS/2 XFree86 port
  691. Hal Brand - for X line and polygon stippling code
  692. Eric Berdahl - for doing much of the internal overhaul work of Mesa for 2.0
  693. Frank Ortega - for bug fixes and many helpful comments
  694. Mats Lofkvist - for finding a number of bugs in Mesa 2.0
  695. Charlie Wallace - for the MS-DOS driver
  696. Li Wei - for updated Windows 95/NT driver
  697. Pete French - for the OpenStep driver
  698. Tinic Uro - for the BeOS driver
  699. Daniel Barrero - for the 3-D texture mapping extension
  700. Randy Frank - for many bug reports/fixes and code contributions
  701. David Bucciarelli - for the 3Dfx driver
  702. Paul Metzger - for Linux version of 3Dfx driver
  703. Daryll Strauss - for the Linux Glide library
  704. Kendall Bennet - for the SciTech MGL driver
  705. Matthew Stewart-Smith - for updating the Linux SVGA driver
  706. Magnus Lundin - for fixing a mipmap bug
  707. Daniel Barrero - for the GL_EXT_point_parameters extension
  708. Josh Vanderhoof - for Intel X86 assembly language optimizations
  709. S3 - for the S3/Virge Windows 95 driver
  710. Ted Jump - for Windows compilation support
  711.  
  712.  
  713. --------------------------------------------------------------------------
  714. $Id: README,v 3.9 1998/08/02 15:51:00 brianp Exp $
  715.